home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / tri_bbs / tridog40.zip / TRIDOG.DOC < prev    next >
Text File  |  1992-06-29  |  8KB  |  265 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.                                  TriDog 4.0
  8.                 A Fido<->TriBBS Message Conversion Program 
  9.                    Copyright (c) 1991 By Mark D. Goodwin
  10.  
  11.      TriDog  is distributed as a  freeware program.  Registered TriBBS
  12.      sysops are  free to use  TriDog with their TriBBS.   Unregistered
  13.      TriBBS  sysops are  free to  use TriDog  during their  board's 30
  14.      evaluation  period.    Any  other  use  of  TriDog  is   strictly
  15.      prohibited.
  16.  
  17.      TriDog is a program that  allows your TriBBS board to participate
  18.      in one of the many FidoNet-type networks.  Essentially, TriDog is
  19.      used to  convert messages  from the Fido  MSG format  to TriBBS's
  20.      message base structure and vice versa.
  21.  
  22.  
  23.      THE TRIDOG DIRECTORY
  24.      ---------------------
  25.  
  26.      The  first  step during  the  TriDog installation  process  is to
  27.      create a directory for the  conversion program and copy the files
  28.      TRIDOG.EXE and RESET.EXE into the newly created directory.
  29.  
  30.  
  31.      THE CONFIGURATION FILE
  32.      ----------------------
  33.  
  34.      Next,  you  must  create  a configuration  file  in  your  TriDog
  35.      directory.  The  configuration file  is the  key to  successfully
  36.      operating TriDog.   This configuration  file is a  straight ASCII
  37.      text file with a name of TRIDOG.CFG.  A sample configuration file
  38.      is included in the TriDog archive and is as follows:
  39.  
  40.      tribbs=c:\tribbs
  41.      address=1:326/304
  42.      tagline=The Lobster Buoy - Home of TriBBS
  43.      conf=25,c:\fd\net326
  44.      conf=21,c:\fd\comm
  45.      conf=22,c:\fd\pdnecho
  46.      conf=23,c:\fd\dr_debug
  47.      conf=24,c:\fd\ooii
  48.  
  49.      You  should  note  that  the  order  of  the  configuration  file
  50.      statements isn't significant.  The following explanations provide
  51.      more  detail  about  each  of  the  TriDog  configuration  file's
  52.      statements:
  53.  
  54.  
  55.      TRIBBS=directory
  56.  
  57.      This is a required configuration  file statement and simply tells
  58.      TriDog where your main TriBBS directory is located.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.      ADDRESS=network address
  74.  
  75.      This is a required configuration file statement and  simply tells
  76.      TriDog your  network  address.   This  address is  necessary  for
  77.      TriDog to correctly  create Fido-style MSG files.   Additionally,
  78.      TriDog will append your address onto your tagline.
  79.  
  80.  
  81.      TAGLINE=tagline
  82.  
  83.      This is a required configuration file  statement and simply tells
  84.      TriDog the  tagline for your board.  TriDog will put this tagline
  85.      and  your network address  in an appropriate  Origin statement at
  86.      the bottom of every exported message.
  87.  
  88.  
  89.      CONF=TriBBS conference number,Fido MSG directory
  90.  
  91.      You  must  specify  at  least   one  CONF  statement  per  TriDog
  92.      configuration  file.  This statement tells TriDog what conference
  93.      number is  being used on  your board for  the conference  and the
  94.      directory for the Fido conference.
  95.  
  96.  
  97.      RUNNING TRIDOG
  98.      --------------
  99.  
  100.      TriDog  is run by simply  entering the command  TRIDOG at the DOS
  101.      command prompt.   You should probably run TriDog  before you pack
  102.      your Fido conferences,  before you poll your host,  and after you
  103.      poll your  host.  Of course you may  run TriDog at anytime during
  104.      the day, but  running it with  the three mentioned  circumstances
  105.      should be sufficient.
  106.  
  107.  
  108.      HIGH MESSAGE POINTERS AND CRC FILES
  109.      -----------------------------------
  110.  
  111.      To be able  to keep track of  what messages have or  haven't been
  112.      exported from your message base,  TriDog maintains a file of high
  113.      message pointers for  all of your board's conferences  and a file
  114.      of CRCs for each conference  that appears in a configuration file
  115.      CONF statement.  The high message pointer file has  a filename of
  116.      TRIDOG.HGH.  The CRC files have filenames of n.CRC.  Where "n" is
  117.      the  conference's number.  Normally, TriDog maintains these files
  118.      automatically.   However, there  are times when  you may  have to
  119.      manually intervene.
  120.  
  121.      For  example, you may reconfigure your message conferences.  This
  122.      is usually no big  deal.  If, however, the changes  you make move
  123.      your  networked conferences around, the high message pointer file
  124.      will  be incorrect, the configuration file's CONF statements will
  125.      be  incorrect, and  the CRC files  will be  incorrectly numbered.
  126.      The solution to preventing such a problem is to run TriDog before
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.      changing your configuration.  Next you should run RESET.EXE, make
  140.      any appropriate changes to the CONF statements in TRIDOG.CFG, and
  141.      then renumber the CRC files by using the DOS REN command. 
  142.  
  143.      A similar situation may occur if you renumber one or more of your
  144.      networked conferences with  TRIPACK.  (Remember, you  should only
  145.      renumber your message  base conferences if they are  in danger of
  146.      rolling over 999,999.)  Simply  run TriDog, run TRIPACK, and then
  147.      run RESET.
  148.  
  149.      You should also note  that the CRC  files only maintain CRCs  for
  150.      the last  5000 messages per conference.   These CRCs  are used by
  151.      TriDog to prevent already exported messages from being reimported
  152.      and to prevent  already imported messages from  being reimported.
  153.      Because TriDog  only keeps  track of the  last 5000  messages per
  154.      conference, you must be sure that your Fido MSG directories never
  155.      have over 5000 MSG files in each directory.  You should also note
  156.      that there's no need to keep anywhere near 5000 MSG files on hand
  157.      for any  conference.   Old messages  should be  routinely deleted
  158.      with your Fido message  packer.  This will not only  save a great
  159.      deal  of  disk  space,  but   it  will  also  speed  up  TriDog's
  160.      performance considerably.
  161.  
  162.      NETMAIL SUPPORT
  163.      ---------------
  164.  
  165.      Starting  with version  4.0, TriDog supports  TriBBS's Fido-style
  166.      netmail conference  feature.   You should  note however  that the
  167.      current version of  TriDog does not  support point addressing  or
  168.      interzone addressing of netmail.
  169.  
  170.  
  171.      SUPPORT
  172.      -------
  173.  
  174.      If you  have any  problems installing and  using TriDog,  you can
  175.      obtain support by  calling either The Lobster  Buoy, 207-941-0805
  176.      or  sending  a message  to  me at  1:328/104.   Please  only make
  177.      inquiries about TriDog or any other TriBBS related problem. There
  178.      are  many  ways you  can  setup  a  Fido  system.   If  you  need
  179.      assistance with a  nonTriBBS-related program, you  should contact
  180.      the program's author for assistance.
  181.  
  182.      The best advice I can give you is to set up a TriBBS board first.
  183.      Then add  the frontend mail program.  Once you are connected with
  184.      a  net and  are starting  to  receive some  echomail, then  setup
  185.      TriDog to handle  the conversion process.  If you  take the whole
  186.      process a  step  at a  time,  you  shouldn't run  into  too  many
  187.      problems.
  188.  
  189.  
  190.      SPECIAL THANKS
  191.      --------------
  192.  
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.      I'd like to especially thank Wayne Price (1:326/0 and 1:326/103).
  206.      Wayne runs net 1:326  has been very patient answering a number of
  207.      really dumb questions about FidoNet in general.  I'd also like to
  208.      thank Mark May (1:110/290) who provided me with all of the latest
  209.      FidoNet technical files.
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.